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This  document  is  one  of  a  series  of  M-892  volumes  established  to  provide 
information  concerning  usage  and/or  operation  of  the  OOPII  executive  system. 

Notes  on  COPII 

A.  INTRODUCTION 

There  sure  a  number  of  restrictions  imposed  upon  the  usage  of  the  COPII 
control  program  (MirCIl)^  which  are  not  obvious  from  the  existing  documen¬ 
tation.  This  document  is  designed  to  clarify  these  areas  and  to  recommend 
a  few  debugging  technlq,ues. 

B.  RESTRICTIONS 

1.  Element  Definition 

An  element  may  be  loaded  from  a  binary  and/or  non-binary  card  deck  by 
MTCn  via  the  CARDS  pseudo  function.  This  element  is  then  referred  to 
as  a  "defined”  element  of  which  there  sure  two  types;  "newly  defined", 
and  "re-defined".  A  "newly  defined"  element  is  one  which  does  not 
exist  on  the  Master  Tape.  A  "re-defined"  element  is  a  temporary  re¬ 
placement  for  ein  element  already  on  the  Master  Tape. 

The  following  illustration  will  be  used  in  the  clarification  of  defined 
elements : 


♦  CARDS  P^ 

DEFINES  A  ARANGE 

Deck  defining  A 
IXFINES  B  BRANGE 

Deck  defining  B 
lEFINES  C  CHANGE 

Deck  defining  C 
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♦  Function 
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B.  RESTRICTIONS 
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The  following  illustration  will  be  used  in  the  clarification  of  defined 
elements : 

*  CARDS  P^ 

DEFINES  A  ARANGE 

Deck  defining  A 
DEFIRES  B  BRANGE 

Deck  defining  B 
lEFINES  C  CHANGE 

Deck  defining  C 


1.  Element  Definition 

An  element  may  be  loaded  from  a  binary  and/or  non-binary  card  deck  by 
MTCH  via  the  CARDS  pseudo  function.  This  element  is  then  referred  to 
as  a  "defined"  element  of  which  there  are  two  types;  "newly  defined", 
and  "re-defined".  A  "newly  defined"  element  is  one  which  does  not 
exist  on  the  Master  Tape.  A  "re-defined"  element  is  a  temporary  re¬ 
placement  for  ein  element  already  on  the  Master  Tape. 
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MTCII  1411  initialize  its  internal  tables  when  the  first  DEFIHES  card 
is  enco\jntered.  This  means  that  the  elements  previously  in  core  will 
not  be  acknowledged.  The  first  element  to  be  defined  will  be  loaded 
into  core  depending  upon  the  field  on  the  CABD6  request.  If  is 
omitted,  the  first  element  will  be  loaded  at  1CX)00B;  otherwise,  P^ 
will  be  used  as  the  starting  location  (P^  must  be  greater  than  or 
equal  to  1CX)00B).  MTCII  will  load  a  binary  and/or  non-binary  deck 
from  cards  reserving  an  area  equal  to  the  length  on  the  DEFiNES  card 
(e.g. ,  ARAN(2!).  At  the  time  a  subroutine  reference  is  encountered, 
when  loading  an  element  from  cards  or  prestored  cards,  a  check  is 
made  to  determine  if  it  has  already  been  assigned  a  location.  If  not, 
an  area  is  reserved  for  that  subroutine  equal  to  the  length  specified 
for  it  in  the  directory.  The  starting  location  for  the  referenced 
subroutine  is  then  substituted  for  its  CODES  number. 

llie  subroutines  referenced  by  the  element  being  defined  are  called 
direct  subroutines  After  assigning  a  starting  location  to  a 

direct  subroutine  reference,  the  environment  required  by  that  sub* 
routine  is  flagged. 

An  element  in  the  environment  of  a  direct  subroutine  is  called  aji 
"indirect"  subroutine  (e.g.,  I^,  an  indirect  subroutine  of  A). 

After  reading  one  element  into  core  from  cards,  MTCII  will  process  the 
next  defined  element,  if  any,  in  the  same  fashion. 

When  the  first  function  request  is  made  after  defining  elements,  areas 
will  be  reserved  for  all  the  indirect  subroutines.  Then  a  storage 
analysis  and  corrector  table  are  listed,  if  so  specified  on  the  func¬ 
tion  request.  All  the  direct  and  indirect  elements  are  loaded  from 
the  Master  Tape  and  the  requested  function  is  operated. 
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The  restrictions  on  the  usage  of  defined  elements  are  as  follovs: 

a.  Core  Requirement 

The  amount  of  core  required  by  elements  A,  B  and  C,  euid  the 
"direct"  elements  of  A  and  B  must  he  less  than  6Q000B  cells.  The 
remaining  environment  of  these  three  elements  (D^,  and  1^) 
may  occupy  core  up  to  76433B.  The  reason  that  the  former  restric¬ 
tion  is  made  is  that  the  code  of  MTCII,  which  controls  the  loading 
of  defined  elements,  occupies  the  area  of  core  from  TOOOOB  to 
76433B,  whereas  the  code  which  loads  elements  from  the  Master  Tape 
is  located  below  lOOOOB. 

b.  Storage  Analysis 

A  storage  analysis  is  defined  as  a  list  of  all  elements  required 
to  operate  the  requested  function  including  defined  elements  and 
their  starting  locations.  A  complete  storage  analysis  will  be 
output  only  for  the  first  defined  function  that  is  requested,  e.g. , 

*  13  A 

*  13  B 

*  13  C 

A  storage  analysis  is  output  when  the  defined  function  A  is  re¬ 
quested,  but  when  B  and  C  are  requested,  only  a  storage  analysis 
heading  will  be  output  unless  B  and  C  were  "newly"  defined  func¬ 
tions.  In  this  case,  B  and  C  would  be  given. 

If  a  function  is  requested,  which  references  the  re-defined 
elements,  those  elements  will  appear  in  the  storage  analysis  even 
if  the  function  request  does  not  immediately  follow  the  definitions. 
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c.  MTCII  Re -load 

If  the  environment  of  B  and  C  exceeds  TOOOOB,  a  flag  internal 
to  MTCII  is  set  indicating  the  fact  that  MTCII  must  be  re-loaded. 
Assume  the  following  function  requests  are  made  after  defining  A, 

B  and  C: 

*  13  A 

*  13  B 

The  function  "A"  will  be  processed  correctly.  After  execution  of 
"A",  MTCII  is  re-loaded  so  that  the  next  function  request  can  be 
processed.  On  a  re-load,  the  corrector  table  is  preserved  and  the 
SOM,  if  any,  is  retained.  In  re-loading,  the  previous  contents  of 
core  is  cleared.  When  the  request  for  the  previously  defined 
function  "B"  is  interpreted,  one  of  two  actions  will  be  taken;  it 
will  either  be  loaded  from  the  Master  Tape,  if  it  exists  on  the 
tape,  or  it  will  be  logged  as  undefined. 

Due  to  this  restriction,  it  is  recommended  that  elements  be  de¬ 
fined  at  the  time  at  which  they  are  needed. 

d.  DEFINES  Length 

When  a  function  or  element  is  re -defined,  the  new  length  from  the 
DEFINES  card  is  not  stored  in  the  directory.  If  SIMDUMP  is  used 
to  dump  that  element,  the  length  from  the  directory  is  used.  If 
the  length  of  the  element  on  the  Master  Tape  is  less  than  the  new 
element,  part  of  the  new  element  will  not  be  listed. 

To  provide  a  means  of  temporarily  cheuiging  the  length  of  a  program 
ih  the  directory,  the  REDEFINE  pseudo  is  available  and  is  described 
in  MTCII  Program  Description. 
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e.  Absolute  Elements 

An  absolute  element  must  observe  the  restrictions  imposed  on 
relocatable  elements,  in  that  it  must  fit  into  the  area  betveen 
lOOOOB  and  TOOOOB,  if  it  is  loaded  via  CARDS. 

f.  SubroTZtine  Reference 

A  defined  element  cannot  reference  a  subroutine  vhicb  is  -in  the 
CODES  table  and  not  on  the  Master  Tape,  even  though  the  subroutine 
has  been  loaded  into  core  via  CARDS.  At  the  present  time,  inter¬ 
communication  between  "newly  defined"  elements  whose  names  appear 
in  the  CODES  tableris  not  possible.  This  capability  will  be 
implemented  in  Mod  AG  of  MPCII. 

g.  Successive  Requests  for  Definitions 

Successive  requests  for  a  defined  function  are  possible  only  if 
the  defined  function  and  its  envlrcnment  do  not  exceed  location 
70OOOB.  A  storage  analysis  will  be  given  on  the  first  request 
but  only  the  "newly  defined"  elements  will  be  displayed  in  the 
following  analyses.  If  the  70000B  limit  is  exceeded,  the  second 
request  for  the  function  will  be  either  undefined,  or  the  function 
will  be  loaded  from  the  Master  Tape.  In  the  latter  case,  an  analy¬ 
sis  of  the  element  from  the  Master  Tape  will  be  output. 

h.  Definition  in  Special  Operating  Mode 

1)  MFCII  must  already  be  in  the  Special  Operating  Mode  (SOM)  prior 
to  defining  a  function  which  utilizes  the  SOM  mode. 

2)  The  function  specified  in  SPETAB,  which  is  operated  by  MTCII 
when  the  SOM  mode  is  Initialized,  cannot  be  defined.  It  must 
be  on  the  Master  Tape. 
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3)  To  remain  in  the  SOM  mode  when  defining  elements,  the  field 
on  the  CARDS  request  must  be  equal  either  to  RCLANK  or  to  an 
address  which  is  greater  than  the  reserved  area  that  starts  at 
lOOOOB.  If  RCLANK  is  used,  MTCII  will  load  the  first  defined 
element  starting  at  the  first  location  following  the  reserved 
area.  In  either  case,  core  will  be  initialized  except  for  the 
reserved  areas. 

h)  To  request  a  function  which  has  previously  been  defined,  an 
N^  field  must  not  precede  the  function  name. 

INCORRECT  CORRECT 

*  RCLANK  A  *  A 

or  *  N^  A  *  A 

An  N^  control  parameter  initializes  the  core  allocation  table, 
which  will  delete  the  defined  elements. 


2.  Usage  of  N„ 

N^  is  a  control  parameter  which  may  precede  the  name  of  the  function 
being  requested.  N^  provides  a  method  by  which  the  starting  location 
for  a  function  may  be  specified.  N^  may  be  equal  to  RCLANK  or  greater 
than  or  equal  to  lOOOOB. 


Successive  Requests  for  Functions 


If  a  function  is  requested  more  than  once  in  succession,  one  of  the 
following  events  will  occur,  depending  upon  the  size  of  area  required 
by  the  function  and  its  environment. 


a)  A  function  and  its  environment  which  exceeds  6(X)00B  cells  in  length 
will  result  in  the  re-load  of  MTCII  after  the  operation  of  the 
first  request.  The  second  or  more  requests  for  the  function  will 
result  in  the  function  and  its  environment  being  loaded  for  each 
request. 
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b)  A  function  and  its  environment,  which  does  not  exceed  60OOOB  cells 
in  length,  will  not  be  re-loaded  for  each  request. 

4.  Usage  of  N3  in  SOM  Mode 

To  request  a  function  which  does  not  utilize  the  SOM  mode,  yet  retain 
the  mode,  the  control  parameter  must  be  specified  on  the  function 
request,  e.g., 

*  RCLANK  DUMP  3  lOB  lOOB 

where  »  RCLAMK.  MTCII  will  automatically  equate  the  location 
counter  to  the  first  address  available  following  the  SOM  reserved  area 
whenever  is  eqvial  to  RCLANK.  This  usage  of  eliminates  the  need 
for  knowing  the  length  of  the  reserved  area.  In  addition,  the  core 
allocation  table  is  initialized  so  that  MTCII  is  not  aware  of  previous 
elements  in  core.  For  this  reason,  SYMIXIMP  cannot  be  used  in  the  SOM 
mode  since  it  depends  upon  the  core  allocation  table. 

5.  Core  Allocation 

When  a  normal  function  request  is  made,  that  is,  the  control  para¬ 
meter  is  omitted,  MTCII  will  allocate  core  in  the  following  manner: 

a)  The  environment  of  the  function  will  be  assigned  locations  in  the 
reverse  order  of  the  CODES  table.  The  element  of  the  environment, 
which  appears  last  in  the  CODES  table,  will  be  assigned  the  first 
available  location  (lOOOOB,  if  core  has  been  initialized  or  the 
function  and  its  environment  requires  more  room  than  is  available). 

b)  The  function  will  be  assigned  the  first  available  address  following 
its  environment.  A  flag  is  set  so  that  after  the  operation  of  the 
function  it  will  be  wiped  out. 

c)  When  the  next  function  is  requested,  MTCII  will  try  to  fit  its 
environment  into  core  immediately  following  the  environment  of  the 
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first  function  (the  last  function  will  he  wiped  out),  providing 
the  second  function  is  not  IXJMP,  SYMKJMP,  or  the  same  as  the 
previous  function.  A  special  case  is  made  for  SYMDUMP  and  LUMP 
to  provide  for  debugging  the  previous  function.  Elements  already 
in  core  will  not  be  re-loaded. 

If  the  second  function  is  for  EWMP  or  SIMDUMP,  the  first  function 
will  be  retained  and  the  environment  of  DUMP  or  SYMDUMP  will 
follow  the  first  function,  and  the  second  function  will  precede 
its  environment.  If  there  is  not  enough  room  for  the  second  func¬ 
tion  between  the  first  available  address  and  TOOOOB,  core  is 
initialized  and  steps  a  and  b  will  be  performed. 

d)  Core  Allocation  Example 

The  following  example  illustrates  the  core  allocation  process: 

Element  requirements  are; 

VMT  requires  OUTPUT  and  UNPACK 

COS  requires  UNPACK,  FLOATBIN  and  SIN 

DUMP  requires  CORE 

The  function  request  for  VMT  (*  VMT)  will  result  in  core  being 
allocated  as  follows; 


10000 

11322 

1133^ 


OUTPUT 

UNPACK 

VMT 
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2.  Iterations  of  Defined  Elements 

It  may  be  desirable  in  the  checkout  of  an  element  to  define  it  and 
call  it  whenever  it  is  desired  to  operate  it.  In  the  COPII  system, 
there  is  no  guarantee  that  a  defined  element  will  remain  in  core  if 
other  functions  are  operated  between  req.uests  for  this  defined  element 
therefore,  it  is  necessary  to  define  the  function  each  time  it  is  to 
be  requested.  To  eliminate  the  need  for  numerous  binary  decks  of  the 
function,  the  definition  of  the  function  can  be  prestored  and  called 
when  needed  by  the  TAPERD  pseudo.  There  are  two  steps  to  this  process 

a)  Prestore  the  defined  function  as  follows: 

*  CARLS 

DEFIKES  RANGE 

Deck  of 

*  X  13  F^ 

The  request  for  F^  is  made  at  this  point  to  merely  load  the 
environment  of  the  function,  to  obtain  a  storage  analysis,  and  to 
terminate  the  defines  mode.  The  operation  of  F^  is  not  actuated 
by  this  request  since  the  "Do  not  Operate"  parameter  (X)  is  used. 
Instead,  the  function  is  requested  eigain  in  the  normal  card  setup 
(see  step  b)  so  that  variable  parameters  may  be  specified.  Note 
that  this  scheme  will  work  only  for  functions  which  do  not  exceed 
location  TOOOOB. 

b)  To  operate  the  defined  function  from  the  prestored  tape,  the 
following  sequence  must  be  executed: 


* 

* 

* 


REWIND  UNIT 
TAPERD  UNIT 


P/^ . . . .  P  ,  M« ....  M 
2  p'  1  m 


l6  April  1963 


aM-892/006/00 


-  12  - 
(Last  Page) 

This  sequence  results  In  rewinding  the  prestored  tape,  reading 
the  defined  program  from  this  tape,  loading  Its  environment  from 
the  Master  Tape,  emd  executing  the  function. 

c)  The  following  example  Illustrates  the  usage  of  this  mode  of 
operation. 


*  IRT 

2 

9  10 

*  WNRT 

*  REWIND 

U 

*  TAPERD 

U 

*  F,  P, .... 

1  1 

P 

*  RUNNUM 

♦  KINJFUN 

♦  REWIND 

U 

*  TAPERD 

U 

P 

♦  F^  P^. . . . 

d)  More  than  one  deck  can  he  defined  following  the  CABD6  card,  as 
well  as  CORRECT  blocks,  i.e. , 

*  CARDS 
CORRECT 

Correctors 
CORRECT  Fg 

Correctors 

DEFINES  F^  RANGE 

Definition  of  F^ 

DEFINES  Fj^  RANCa: 

Definition  of  F|^ 

*  13  X  F^ 
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